---
layout: zh-CN/default
title: 安装 &middot; Rust 程序设计语言
---
    <h1 class="rustup">安装 Rust</h1>

    <div class="row rustup-row">
      <div class="col-md-8 instr-column">
        <div id="platform-instructions-unix" class="instructions" style="display: none;">
          <p>要安装 Rust 时，请在终端中运行以下命令，然后按照屏幕上的提示进行操作。</p>
          <pre>curl https://sh.rustup.rs -sSf | sh</pre>
        </div>

        <div id="platform-instructions-win" class="instructions" style="display: none;">
          <p>
            安装 Rust：下载并运行
            <a href="https://win.rustup.rs">rustup&#x2011;init.exe</a>
            然后按照屏幕上的说明进行操作
          </p>
        </div>

        <div id="platform-instructions-unknown" class="instructions" style="display: none;">
          <!-- unrecognized platform: ask for help -->
          <p>无法识别您的平台</p>
          <p>
            可以运行在 Windows, Linux, Mac OS X, FreeBSD 和 NetBSD 上。
            如果您正在这些平台上，并且看到这句话，请您
            <a href="https://github.com/rust-lang/rust-www/issues/new">报告问题(issue)</a>，
            并且提供以下信息：
          </p>

          <div>
            <div>navigator.platform:(浏览器.平台)</div>
            <div id="nav-plat"></div>
            <div>navigator.appVersion:(浏览器.版本)</div>
            <div id="nav-app"></div>
          </div>

          <!-- duplicate the default cross-platform instructions -->
          <div>
            <p>要安装 Rust 时，如果您正在使用 Unix，<br/>请在终端中运行以下命令，
            然后按照屏幕上的提示进行操作。</p>
            <pre>curl https://sh.rustup.rs -sSf | sh</pre>
          </div>

          <hr/>

          <div>
            <p>
              如果您正在使用 Windows 操作系统，<br/>下载并运行
              <a href="https://win.rustup.rs">rustup&#x2011;init.exe</a>
              然后按照屏幕上的说明进行操作。
            </p>
          </div>
        </div>

        <div id="platform-instructions-default" class="instructions">
          <div>
            <p>要安装 Rust 时，如果您正在使用 Unix，<br/>请在终端中运行以下命令，
            然后按照屏幕上的提示进行操作。</p>
            <pre>curl https://sh.rustup.rs -sSf | sh</pre>
          </div>

          <hr/>

          <div>
            <p>
              如果您正在使用 Windows 操作系统，<br/>下载并运行
              <a href="https://win.rustup.rs">rustup&#x2011;init.exe</a>
              然后按照屏幕上的说明进行操作。
            </p>
          </div>
        </div>

      </div>

      <div class="col-md-4 release-info-column">
        <div>
          <div class="release-version">Rust <span>{{ site.stable }}</span></div>
          <a href="{{ site.stable_blog }}">
            <div class="release-date">{{ site.stable_date | date: "%Y 年 %-m 月 %-d 日" }}</div>
          </a>

          <br>

          <a id="platform-button" style="display: none;" href="#">
            点击或按下 「n」 键更换平台
          </a>
        </div>
      </div>

    </div>

    <h2>关于 Rust 安装的注意事项</h2>

    <div class="row">
      <div class="col-md-12">

        <h3>使用 <code>rustup</code> 管理工具链</h3>

        <p>
          Rust 由
          <a href="https://github.com/rust-lang-nursery/rustup.rs"><code>rustup</code></a>
          工具来安装和管理。 Rust 有一个 6 周的
          <a href="https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md">
            快速发布过程
          </a> 并且支持
          <a href="https://forge.rust-lang.org/platform-support.html">
             大量的平台
          </a>，所以任何时候都有很多 Rust 构建可用。
          <code>rustup</code> 在 Rust 支持的每一个平台上以一致的方式管理这些构建，
          并可以从 beta 和 nightly 发布渠道安装 Rust，且支持额外的交叉编译目标平台。
        </p>

        <p>
          更多信息请查看
          <a href="https://github.com/rust-lang-nursery/rustup.rs/blob/master/README.md"><code>rustup</code>
          documentation</a>。
        </p>

        <h3>配置 <code>PATH</code> 环境变量</h3>

        <p>
          在 Rust 开发环境中，所有工具都安装到
          <span class="platform-specific not-win" style="display: inline;">
            <code>~/.cargo/bin</code>
          </span>
          <span class="platform-specific win" style="display: none;">
            <code>%USERPROFILE%\.cargo\bin</code>
          </span> 目录，
          并且您能够在这里找到 Rust 工具链，包括
          <code>rustc</code>、<code>cargo</code> 及 <code>rustup</code>。
        </p>

        <p>
          因此，Rust 开发者们通常会将此目录放入
          <a href="https://en.wikipedia.org/wiki/PATH_(variable)"><code>PATH</code>
          环境变量</a>。在安装时，<code>rustup</code> 会尝试配置 <code>PATH</code>，
          但是因为不同平台、命令行之间的差异，以及 <code>rustup</code> 的 bug，对于
          <code>PATH</code> 的修改将会在重启终端、用户登出之后生效，或者有可能完全不会生效。
        </p>

        <p>
          当安装完成之后，如果在控制台运行 <code>rustc --version</code> 失败，这是最可能的原因。
        </p>

        <div class="platform-specific win">

          <h3>Windows 注意事项</h3>
          <!-- This anchor is probably linked in the wild and should not be broken -->
          <a id="win-foot"></a>

          <p>
            在 Windows 上， Rust 需要 Visual C++ 生成工具 2013 或更新版本的支持。获取 Visual C++ 生成工具最方便的方法是安装
            <a href="https://www.visualstudio.com/downloads/#build-tools-for-visual-studio-2017">
              Microsoft Visual C++ Build Tools 2017
            </a>
            。或者，你可以
            <a href="https://www.visualstudio.com/downloads/">安装</a>
            Visual Studio 2017, Visual Studio 2015, 或 Visual Studio 2013 并在安装过程中选择安装 「C++ 工具」。
          </p>

          <p>
            关于在 Windows 上配置 Rust 的更多信息请查看
            <a href="https://github.com/rust-lang-nursery/rustup.rs/blob/master/README.md#working-with-rust-on-windows">Windows-specific <code>rustup</code>
            文档</a>。
          </p>

        </div>

      </div>
    </div>

    <h2>其他安装方法</h2>

    <div class="row">
      <div class="col-md-12">
        <p>
         上述通过 <code>rustup</code> 的安装方法是大多数开发者的首选。
          此外， Rust 也可以
          <a href="other-installers.html">通过其他方法安装</a>。
        </p>
      </div>
    </div>

    <script type="text/javascript">
      {% include rustup.js %}
    </script>
